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Line 1 specifies the match condition: this template will 
match any element that contains a wdktags:attachTo sub- 
element. Section 2 contains XSL logic for determining what 
root element should be used as the starting point for the 
value of the path attribute. If the developer specifies a root 5 
attribute, then the value of that attribute is used, otherwise 
the root element defaults to the wdkrmodel node of the 
model page. Section 3 invokes the getNodes ( ) method on 
the WDKDomUtils class. That method returns the set of 
nodes that can be accessed from the root node through the lO 
path given in the path attribute of the wdktags:attachTo 
directive. Section 4 checks for error conditions and sets up 
the iteration through the set of DOM elements returned in 
section 3. In section 5 the current xsp node (the value of the 
xspCurrentNode variable) is saved on a stack, and its value 15 
is replaced with the next node from the set of nodes returned 
in section 3. Since the XSP processor uses the xspCurrent- 
Node variable to mark the current "insertion point" — i.e. the 
location where the next DOM node will be inserted in the 
Document, this operation effectively copies the current 20 
subtree (the widget) to each node returned in section 3. 
(Sections 6 and 7 perform the actual copying.) Finally, 
section 8 restores the value of the xspCurrentNode and 
resumes the iteration. 

The following section describes the implementation of the 25 
nodeRef tag. 
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rule for rendering wdk:page is to generate the <html> 
element, the <head> element containing the <title> element. 
These common templates are all grouped in a default 
stylesheet that can be imported using the <xsl:import> 
directive by every view page. As a result, for simple pages, 
the view page needs to contain a singe cusomized xsl tem- 
plate rule that matches on the "wdkimodel" node. This 
template is responsible for rendering the data as well as the 
widgets. 

Example: default view transformation templates 



1 <?xml versioD»"'1.0"?> 

<xsl:stylesheet version="1.0" xinlns:xsl»" http://www.w3.oig/ 
1999/XSl/rransfonn" 

xnilns : wdk-" hUp ://www.sa ba .com/XML/WD K"> 
<xsI:output mcthod=**xmr* indent»''ycs'7> 
<xsl:slrip -space clements=**''7> 

2 <xsl:template match"/''> 

<xsl:variable name-"titlel^bel"><xsl;vaIue-of select- 

"//wdk:hcad/wdk:titlc*Y><yxsl:variablc> 

<htinl> 

<head> 

<litle><xsl:value-of select="$tiUeLabcrv></liU&> 
</head> 
<body> 

<xsl app 1 y- teinplates/> 



1 <xsl:tcinplatc match-**wdktags:nodcRcf '> 

2 <xsl: variable name=**root"> 

<xsI:choose> 

<xsl:wheD tcst""@source"><xsl:value-of-select=*'@source*V><yxsl:whcn> 
<xsl:otherwise>wdkwidgetNode</xsl:otherwise> 
</xs!:choose> 
</xsl :variable> 

3 <xsp:logic>{ 

Bement wdkChiWNode = WDKDomUtils.gctChildNode((EleincDt)<xsl:value-of 
selcct»"$roor7>,"<xs!:valuc-of selcct="path'7>")i 

<xsp:content><ocsp:cxpr>WDKDomUtils.getTextValue(wdkChildNode)</xsp:expr></xsp:conU^ 

</xsp:logic> 
</xsl:template> 



Line 1 specifies the match condition; this rule matches 
every nodeRef tag. Section 2 determines the root node: if the 
source attribute is given then the value of that attribute is 
used, otherwise the value of wdkwidgetNode Java variable 
is used. The wdkwidgetNode variable is initialized in the 
wdktags:attachTo template described above. This way, if 
nodeRef is used in the context of an attachTo tag, the root 
node is the same node the widget. is copied to. The actual 
node whose value is needed is located by following the path 
from the root node. Finally, the text value of the node is 
computed by calling the WDKDomUtils.getTextValue ( ) 
method. 

Structure of \^ew Pages 

View pages are XSLT stylesheets. The role of the view 
stylesheet is to convert the XML document produced by 
executing the model file (and the subsequent widget 
transformation) to a formal understood by the user agent. 
For example, for desktop browsers this typically means 
conversion to an HTML representation. Since model pages 
have a well-defined structure, view pages are also highly 
regular. For example, there are a number of model page 
elements that should not be rendered (such as wdk:head 
clement and its content should not be copied to the output). 
Other model pages nodes have a standard representation in 
HTML (or in the desired output format). For example, the 
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</body> 
</html> 
</xsl: tempi ato 

3 ocshtemplate match="* | @*|textO!cominentO*' priority ="-!"> 
5Q <xsl;copy> 

<xsl:apply-templates select-"* | @*|uxt0|comment0'7> 
</xsl:copy> 
</xsl:template> 

4 <!" eliminate the wdk:hcad element and all children of 
wdt: widgets -> 

<xsl:template match="wdk:head | wdk:widgets"> 
</xsl: tempi ato 

5 <!-- replace widget with span (so we can do CSS on it) and process 
their children -> 

<xsl:template [natch="wdknvidget"> 
<span class="{@naine}"> 
<xsl:apply-tcinplates/> 
60 </span> 
<br/> 
</x«l: tempi ato 

6 <xsl:template match-"wdk:page"> 

<xs]:appIy-tenrq:latC5/> 
</xsl: tempi ato 
65 </xsl:5tyIesheet> 
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Section 1 defines the namespaces used in the stylesheet. 
Section 2 defines the root level template. This template 
produces the hi ml tags, and generates the html head element 
complete with the title element. Section 3 defines the default 
template: every element, attribute, text and comment is 
copied to the resulting document, unless a more specific 
template provides different instructions. Section 4 specifies 
a template for eliminating the wdk:head and wdk: widgets 
elements and their contents (since the contents of these lags 
should not be rendered using the default template defined in 
section 3). Section 5 introduces a template for transforming 
every widget by wrapping them into a span element replac- 
ing the wdk:widget "wrapper''. This makes it possible to use 
CSS styling on a per named-widget basis. Finally, section 6 
defines the template for processing the wdkipage element. 
A View Page Example 



1 <?xml vcisioii-"1.0"?> 

<xsl:styleshcet version-** 1.0" xmlns:xsl="http://www. w3.org/ 
1999/XSUTransfonn" 

xm! ns: wdk="http :/Avww. saba .com/XM I7WD K"> 

2 <xsi:iinport href«»"../xsl/view/wdk_defaultview.xsr7> 

3 <xsl:lemplate match*'" wdk:inodcr'> 

4 <h2 aUgii»"center''><xsl lvalue- of 
6elect-"/wdk :page/wdk:head/wdk: t ill e7> </h2 > 

5 

<xsh valuc-of s cl cct"'*/wdk :poge/wdk :hcad/wdk :lab cls/wdkilabcl 
(@namc»*namcl-abcrj7> 
6 <xsl:for-cach sclcct""parent5/parcnt"> 

<xsI:value-of select-'* name*y> 

<xsl:text> > </xsl;tcxt> 
<;/xsl:for-each> 

<xs[:value-of select="parcnts/leaf/name'7> 
</p> 
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-continued 



7 <xs]:apply-templatcs sclect»"//wdk:widgct*7> 

8 ^sl:teinplaie> 
^sl:£tylesheet> 



Section 2 imports the stylesheet containing the default 
templates. Line 3 defines the rule for processing the wdk- 
: model node. Line 4 displays the title of the page by 
10 accessing the wdk: title tag inside the wdk: he ad tag. Section 
6 iterates through each "parent" element inside the wdk- 
: model element and displays its name. In section 7 any 
widget produced by the model page is displayed. 
The wdk taglibrary 

The wdk taglibrary contains a number of tags to simplify 
the development wdk model pages. The tag library includes 
tags for: 

handling resource bundles for page internationalization, 

invoking commands to generate XML representation of 
the data retrieved from the database, 

managing the connectivity between widgets and the pro- 
duced data model, 

managing the input and output parameters to the model 
page, 

etc. 

25 To make the tag library accessible by the processing 
engine, the following line is inserted in cocoon .properties; 
processor.xsp.logicsheet.wdktags.java-s:/sys/java/web/ 

com/saba/web/xsl/taglibAvdk_taglib.xsl 
The value of the above property identifies the location of 
30 the taghbrary stylesheet, Tlie taglibrary stylesheet contains a 
number of xshimport directives to import templates respon- 
sible for implementing subsets of tags and it also contains a 
number of default templates, as the code example below 
shows: 



<?xinl version"!. 0" encoding-" UTF-S"?> 

<xsl:stylesheet version="1.0" xmlns:xsl-*'http:/Avww.w3. org/1 999/XSL/rraiis form" 
xmlns :xsp="http ://www.apachc.org/19g9/XSP/Core" 
xmlns :wdktags="http :/Avww.saba . cotn/XM lyWDK/taglib " 
xmlns :wdk="http;//www.saba.com/XM L/WDK"> 
<xsl:prcserve-^ace elements ="*"/> 
<xsl:includc hrcf-"wdk_^aram.xsr7> 
<xsl:include href="wdk^il8n.xsr7> 
<xsl:include href="wdk^command.K5l"/> 
<xsl:include href="wdt_control.xsr7> 
<xsl:include hrcf"'*wdk_5ite.x5r7> 
<xsl:template match="xsp:page"> 
<xsl:copy> 

<t — need to explicitly call some logic in the wdk_conimand stylesheet -> 

<xsl:cali-tcmplatc name-" command hcader'7> 

<! — need to explicitly call some logic in the control stylesheet -> 
<xsl: call-temp late namc-"control_Jieader"/> 
<xsl :app] y- temp la tes/> 
</xsl :copy> 
</x5l:template> 

<xsl:template match="@*|*|tcst( )|processing-instruction( )|comment( )" priority-"- 1"> 
<xsl:copy> 

<xst: apply- templates select="@*|*|lext( )|processing-instruclion( )|comment( )'7> 
</xsl:copy> 
<;/xsl:temp1ate> 

<xsl: template match="wdk:hcad"> 
<xsl:copy> 
ovdk:site> 

<hre f >/<xsp :expr > wdkR Oct <yxsp :expr>/</href > 

<imageRoot><xsp:cxpr>wdkSite.getImageRoot( )</xsp:expr></imageRoot> 
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